SVG Diagram Style Guide

Conceito Perene

SVG Diagram Style Guide

The canonical visual style for all diagrams across agricidaniel’s Claude Code skill repos. Extracted from the 17 production SVGs in claude-ads. Use this as the reference when creating or updating diagrams for any skill repo.

Font

font-family: 'Space Grotesk', system-ui, -apple-system, sans-serif

Space Grotesk is the only typeface. No fallback to serif or monospace.

Color Palette

Core (use these in every diagram)

TokenHexRole
bg#0A0A0ACanvas background (near-black)
card#111111Card/container fill
card-inner#1A1A1ANested element fill
border#2D2D2DCard borders, dividers
text-primary#F5F5F0Headings, labels (off-white)
text-secondary#888888Descriptions, captions
text-tertiary#6a6a6aDe-emphasized metadata
accent#E07850Primary accent, arrows, highlights (warm rust-orange)
accent-bright#FF6B35Secondary accent, hover states (brighter orange)

Platform/Category Colors (use for variety within a diagram)

TokenHexTypical use
blue#60A5FAGoogle, data, information
purple#8b5cf6Meta, strategy, creative
cyan#06b6d4LinkedIn, networking
green#4ADE80Success, validation, TikTok
rose#F43F5EYouTube, alerts
orange#FF6B35Microsoft, secondary accent
gray#888888Neutral, generic platforms

Status Colors (for pass/warn/fail indicators)

TokenHexRole
pass#16a34aPass, success
warn#f59e0bWarning, attention
fail#dc2626Fail, critical

Typography Scale

ElementSizeWeightColorExtra
Diagram title16-17px700#F5F5F0text-anchor: middle
Subtitle11px400#888888text-anchor: middle
Section label13px700accent colorletter-spacing: 2
Card heading12-15px600-700#F5F5F0text-anchor: middle
Card subtext9-11px400accent colorSkill/agent name
Body text10px400#888888Descriptions
Tiny label9px400#6a6a6aMetadata, counts

Layout Primitives

Outer Container

<rect width="800" height="500" fill="#0A0A0A"/>

Standard canvas is 800x500. Some diagrams use 900x250 or 900x350 depending on content.

Card

<rect x="40" y="20" width="720" height="120" rx="16" fill="#111111" stroke="#2D2D2D" stroke-width="1.5"/>
  • Corner radius: rx="16" for outer containers
  • Border: #2D2D2D, stroke-width="1.5"

Colored Top Bar (card accent)

<rect x="40" y="20" width="720" height="4" rx="2" fill="#E07850"/>

4px height, sits at the top edge of the card. Color indicates category.

Inner Card (nested element)

<rect x="60" y="230" width="105" height="60" rx="6" fill="#1A1A1A" stroke="#2D2D2D" stroke-width="1"/>
  • Corner radius: rx="6" for small inner cards, rx="9" for medium
  • Fill: #1A1A1A (slightly lighter than parent card)

Numbered Circle (for sequences)

<circle cx="138" cy="60" r="14" fill="#0A0A0A" stroke="#60A5FA" stroke-width="1.5"/>
<text x="138" y="60" font-size="12" fill="#60A5FA" text-anchor="middle" font-weight="bold" dominant-baseline="central">1</text>

Circle stroke color matches the step’s category color.

Arrow Connector

<line x1="400" y1="140" x2="400" y2="170" stroke="#E07850" stroke-width="1.5"/>
<polygon points="394,167 400,177 406,167" fill="#E07850"/>

Always #E07850. Vertical for flow-down, horizontal for left-to-right pipelines.

Horizontal Divider (title underline)

<line x1="380" y1="36" x2="520" y2="36" stroke="#E07850" stroke-width="2.5" stroke-linecap="round"/>

Short centered line under diagram title. Always accent color.

Diagram Types (from claude-ads)

#NameLayoutSize
01Architecture3-layer vertical stack800x500
02Parallel AuditAgent grid with flow800x500
04Platform ChecksChecklist columns800x500
05Quality GatesRule cards800x500
06How It WorksStep sequence900x250
07Data FlowHorizontal pipeline900x250
08Industry TemplatesCard grid900x350
10MCP IntegrationConnection diagram800x500
12Privacy FlowVertical flow800x500
13Scoring AlgorithmFormula breakdown800x500
14Creative Pipeline5-step horizontal900x250
15Platform Grid2-row card grid900x350
16PDF PipelineProcess flow900x250
17A/B TestingSplit comparison800x500
18PPC CalculatorsTool cards900x350
19Audit LifecycleCircular flow800x500
20Install MethodsOption cards900x250

Rules

  1. Always dark theme. Never white or light backgrounds.
  2. Space Grotesk only. No other fonts.
  3. #E07850 is the signature accent. Use it for arrows, highlights, and the primary visual element.
  4. Cards always have #2D2D2D borders. Never borderless cards.
  5. Colored top bars (4px) identify categories. One color per category, consistent across the diagram.
  6. Text is always left-aligned or center-aligned. Never right-aligned.
  7. No gradients, shadows, or blur filters. Flat design only.
  8. Numbered circles for sequential steps. Color matches category.
  9. Arrow connectors are always #E07850 with triangle tips.
  10. File naming: zero-padded number prefix (01-, 02-, etc.) + kebab-case description.